home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / biz / demo / origins.lzh / ReadMe_Demo < prev    next >
Text File  |  1993-04-25  |  11KB  |  252 lines
  1. File: ReadMe_Demo - Origins Demo documentation         Last Update: 26 Apr 1993
  2.  
  3.  
  4.                       *******************************
  5.                       *     Origins_Demo V1.07      *
  6.                       * ©1993 by The Puzzle Factory *
  7.                       *     All Rights Reserved     *
  8.                       *******************************
  9.  
  10.  
  11. Legal Stuff
  12. ===========
  13. This program is NOT Shareware or Public Domain.
  14. It is Copyright ©1992-93 by The Puzzle Factory, Inc.
  15. This version of Origins is freely redistributable provided the following
  16. rules are followed:
  17.  
  18.     1. Only reasonable media costs may be charged.
  19.  
  20.     2. The program and documentation may not be modified in any way.
  21.  
  22.     3. The entire distribution, as described below, must be distributed
  23.        in its original, unaltered form.
  24.  
  25. The Puzzle Factory, Inc. will be in no way liable for damages, incidental, or
  26. consequential, arising from the use or misuse of the Origins Demo or for any
  27. other claim by any other party.  Use this program at your own risk.
  28.  
  29. Origins is a trademark of The Puzzle Factory, Inc.
  30. Amiga and AmigaDOS are trademarks of Commodore-Amiga, Inc.
  31.  
  32.  
  33. Archive Contents
  34. ================
  35. The distribution of files for the Origins Demo is listed below:
  36.  
  37.   Origins_Demo                 The main executable
  38.   Origins_Demo.info            Icon for Origins
  39.   Install_Origins              Script for quick temporary installation
  40.   Install_Origins.info         Icon to execute script
  41.   ReadMe_Demo                  This file
  42.   ReadMe_Demo.info             Icon to view this file
  43.   Tutorial.doc                 An entry level tutorial
  44.   libs (dir)
  45.        arp.library             Required library
  46.   Data (dir)
  47.        genfile                 The empty data bases
  48.        persfile
  49.        ordfile
  50.        marrfile
  51.   Stuff (dir)
  52.        Origins_Demo.doc        On-line help file for Origins
  53.        Banner.ilbm             Initial screen with cute generic people
  54.        TafelHeader.txt         Header file for Tiny-Tafel generator
  55.   Iff (dir)
  56.        IFF.txt                 Placeholder in empty directory
  57.   Notes (dir)
  58.        Notes.txt               Placeholder in empty directory
  59.   ARexx (dir)
  60.        ARexxFuncs.txt          What ARexx functions are available
  61.        ATest.rexx              A sample of the Origins ARexx functions
  62.        EditGen.rexx            Edit SOURCE and NOTE files from within Origins
  63.        Ed_Gen.rexx             Same as above, using Ed
  64.        No_Rexx.rexx            Same as above, for editors without ARexx port
  65.  
  66.  
  67. What is Origins?
  68. ================
  69. Origins is a dedicated data base manipulation program for keeping track of
  70. genealogical information.  The number of records is limited in practice only
  71. by available memory and storage.  You may track attributes of people, such as
  72. where and when they were born, died and were buried, marriages, and parent/
  73. child relationships.  Extra details, such as baptism, confirmation, and
  74. immigration dates, occupation, etc., for all of the persons are also allowed
  75. for.  Origins is capable of maintaining files on approximately 2000 persons
  76. and 500 marriages on a single floppy data disk.  Larger data bases can be
  77. constructed on a hard-disk based system.
  78.  
  79. Origins will run on any Amiga with a minimum of 1 MB of ram, under V1.3 or
  80. V2.0 of the OS.  A printer is really necessary too, as you will undoubtedly
  81. want listings.  If printing Pedigree Charts is desired, the printer must also
  82. support condensed (136 column) printing.  Origins requires Arp library, V1.3
  83. or later.
  84.  
  85. Origins is not intended to be used for religious purposes, and does not
  86. conform to standards for LDS submissions.  The Ordinance file does not
  87. provide for christenings, sealings, priesthood status, or other required
  88. information.  Please do not use Origins for this purpose.
  89.  
  90.  
  91. How do I install Origins?
  92. =========================
  93. For a quick trial installation before you move any files around, double-click
  94. on the "Install_Origins" icon.  For a more permanent and flexible
  95. installation, do the following:
  96.  
  97. 1. Copy the executables somewhere in your path:
  98.  
  99.     copy Origins               SYS:Tools/    ;or C:
  100.     copy Origins.info          SYS:Tools/
  101.  
  102. 2. Copy arp.library to libs:
  103.  
  104.     copy arp.library           libs:
  105.  
  106. 3. If you have ARexx on your system, copy the rexx scripts:
  107.  
  108.     copy ARexx/ATest.rexx      REXX:
  109.     copy ARexx/EditGen.rexx    REXX:
  110.  
  111. In order for Origins to have the flexibility to be used on a wide variety of
  112. hardware, from systems with floppy drives and limited memory, to systems with
  113. multiple hard drives and megabytes of ram, it relies on the use of logical
  114. assignments for its working directories.  Origins looks for various files in
  115. certain logical directories:
  116.  
  117.       GenData:   persfile, ordfile, marrfile,
  118.                  pcindex, mindex, genfile
  119.       GenIff:    Person, Ordinance, Marriage, and Family Group pictures
  120.       GenNotes:  Person, Ordinance, Marriage, and Family Group notes
  121.                  Person , Ordinance and Marriage source files
  122.       GenStuff:  Origins.doc, Banner.ilbm, TafelHeader.txt
  123.  
  124. 4. In order that Origins may operate properly, you must add the following
  125.    lines to your startup-sequence (or enter them before running Origins):
  126.  
  127.       Assign GenData:  <PathName1>
  128.       Assign GenIff:   <PathName2>
  129.       Assign GenNotes: <PathName3>
  130.       Assign GenStuff: <PathName4>
  131.  
  132.    where PathNameN is the name of the directory where you want Origins to
  133.    keep its files.  If you are not familiar with this, here is an example to
  134.    help get you started:
  135.  
  136.       Assign GenData:  DH0:MyFamily
  137.       Assign GenIff:   DH2:MyFamily/Pictures
  138.       Assign GenNotes: DH1:MyFamily/Notes
  139.       Assign GenStuff: DH0:MyFamily/Files
  140.  
  141.    I find this arrangement helpful:
  142.  
  143.       Assign GenData:  Work:Gen/Data
  144.       Assign GenIff:   Work:Gen/Iff
  145.       Assign GenNotes: Work:Gen/Notes
  146.       Assign GenStuff: Work:Gen/Stuff
  147.  
  148.    As you can see, the names of the assignments don't have to match the
  149.    logical names.  They also don't have to be on the same volume or disk.  If
  150.    you have floppy drives only, you can do the following:
  151.  
  152.       Assign GenData:  DataDisk:
  153.       Assign GenIff:   PictureDisk:
  154.       Assign GenNotes: NoteDisk:
  155.       Assign GenStuff: DataDisk:
  156.  
  157.    where the above names are three separate physical floppy disks.  This will
  158.    help you by leaving room for data on the GenData: disk, and not filling it
  159.    up with pictures or notes.
  160.  
  161. 5. After creating the logical assignments, you MUST:
  162.  
  163.       copy Stuff/Origins.doc     GenStuff:     ;The hypertext documentation
  164.       copy Stuff/TafelHeader.txt GenStuff:     ;Header file for Tiny-Tafels
  165.       copy Stuff/Banner.ilbm     GenStuff:     ;Initial picture w/cute people
  166.  
  167.       copy Data/genfile          GenData:      ;The empty data bases
  168.       copy Data/persfile         GenData:
  169.       copy Data/ordfile          GenData:
  170.       copy Data/marrfile         GenData:
  171.  
  172. These are the files required to use all the features of Origins.  There are
  173. other files in the archive that you may want to copy.
  174.  
  175. 6. In the ARexx directory is a file named "EditGen.rexx".  This script allows
  176.    Origins to automatically call your editor when you want to edit source
  177.    documentation and note files.  The "PROJECT/Edit Source Files/:"  and
  178.    "PROJECT/Edit Note Files/:" provide these functions.
  179.  
  180.    Your system must be running ARexx to use these functions.  Also, the ARexx
  181.    macro must match the configuration of your editor to use these functions
  182.    successfully.  If they don't match, load "EditGen.rexx" into your editor,
  183.    and follow the instructions you will find in that file.
  184.  
  185. When you select the "Create Parent/Child Index" and "Create Marriages Index",
  186. Origins will create pcindex and mindex in the GenData: directory.
  187.  
  188. Origins is now installed, and ready to work for you.  Please see the file
  189. "Tutorial.doc" to learn how to put Origins to work.
  190.  
  191.  
  192. Differences between the Commercial and the Demo Versions
  193. ========================================================
  194. This is the DEMO version of Origins.  Some functions are either disabled or
  195. missing from this version of the program.  This list points out the major
  196. differences between the commercial and the demo versions:
  197.  
  198.  1. In the commercial version, the number of records are basically limited
  199.     only by available storage.  In the demo version, the user is limited to
  200.     100 person records, 100 ordinance records, and 50 marriage records.
  201.  2. In the commercial version, if the Banner.ilbm is missing, we just don't
  202.     show the banner.  In the demo version, we complain and exit.
  203.  3. In the commercial version, if genfile, persfile, ordfile, or marrfile is
  204.     missing, they are created.  In the demo version, we complain and exit.
  205.  4. In the demo version, the About requester is shown as you enter the
  206.     program.  In the commercial version, it is shown only if requested.
  207.  5. In the commercial version, the user can increase the size of the
  208.     persfile, ordfile, and marrfile.  In the demo version, when calling these
  209.     functions, a requester stating that these functions do not exist is
  210.     displayed instead.
  211.  6. In the commercial version, if the data bases are full, the user may be
  212.     automatically asked if they would like to increase the size of the data
  213.     bases.  Because the AutoSiz flag in User Preferences is disabled in the
  214.     demo, the user will just be informed that the data bases are full.
  215.  8. In the demo version, the ARexx function, GENAPPENDRECORDS(), has the
  216.     active code removed, and, if no other errors, always returns that it
  217.     added zero records.
  218.  9. In the demo version, the File and Printer gadgets are disabled for the
  219.     entire List Menu except for "List Person's Records".
  220.  
  221. Additionally, several utilities are provided with Origins, and are not
  222. included in the demo version.  Two of these deal with GEDCOM files.  ToGED
  223. is used for creating GEDCOM files from a data base, and FromGED is used for
  224. reading GEDCOM files and creating a data base.
  225.  
  226. GEDCOM stands for GEnealogical Data COMmunication, and was developed by the
  227. Family History Department of the Church of Jesus Christ of Latter-day Saints.
  228. GEDCOM is a standardized method of representing genealogical data, designed
  229. to allow transfer of information between diverse computer systems.  Without
  230. it, a person might be forced to re-enter a large data base by hand merely to
  231. move their family tree from one genealogy program to another.
  232.  
  233. Together, ToGED and FromGED allow you to import and export genealogical data
  234. to and from Origins.  If you have a need for GEDCOM in your genealogical
  235. work, please contact The Puzzle Factory (listed below) for the commercial
  236. version of Origins.
  237.  
  238.  
  239. How do I order the Commercial Version?
  240. ======================================
  241. If you find this program useful, contact:
  242.  
  243.   The Puzzle Factory
  244.   P.O. Box 986
  245.   Veneta, OR 97487
  246.   800:828-9952
  247.   503:935-3709
  248.  
  249. or call your dealer to purchase the commercial version of Origins.
  250.  
  251. =eof=
  252.